<HTML>

<HEAD>
	<TITLE>EETransfer Off-line documentation</TITLE>
</HEAD>

<BODY BACKGROUND="../pict/fond.gif" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#FF0000" VLINK="#FF0000">

<TABLE WIDTH=598 BORDER=0 CELLPADDING=0 CELLSPACING=0>


<TR >
		<TD WIDTH=120 ALIGN="center" NOWRAP>
		<A HREF="mailto:mail@easter-eggs.com" >
		<IMG SRC="../pict/mailee.gif" ALT="Mail to EE" WIDTH=81 HEIGHT=19 BORDER=0>
		</A>
		</TD>

		<TD WIDTH=20 NOWRAP>
		</TD>
		
		<TD WIDTH=5 NOWRAP>
		</TD>
		
		<TD WIDTH=226  ALIGN="center" VALIGN="top" NOWRAP>
		<IMG SRC="../pict/logo.gif" WIDTH=100 HEIGHT=100 BORDER=0>
		</TD>


		<TD WIDTH=227 VALIGN="center" NOWRAP>
		<H1>EETransfer Off-line documentation</H1>
		<FONT SIZE=+2><B><A HREF="../docsum.html">Back to summary</A></B></FONT>
		</TD>
		


</TR>

<TR >
		<TD WIDTH=120 >
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  COLSPAN=2>
		<IMG SRC="../pict/bbar.gif" WIDTH=453 HEIGHT=30 BORDER=0>
		</TD>


</TR>
	
<TR >
		<TD WIDTH=120 ALIGN="center" VALIGN="top">
		Updated 97/06/24
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  ALIGN="left" COLSPAN=2> 
		<FONT SIZE=+2><B>SendZModem</B></FONT>
		<BR><HR>
<B>Send one or several files using the ZModem protocol.</B>


<BR><BR>


<B>* batch</B>

<BR>

<B>type:</B> boolean
<BR>
<B>default value:</B> nil
<BR>


If this option is set then the instruction will attempt to send all OutBox
files that are selected.
<BR>
<I>This option should not be set if either "command" or "ioBoxItem" is not nil.</I>
<BR><BR>


<B>* charset</B>

<BR>

<B>type:</B> symbol
<BR>
<B>possible values:</B> defined in the file "EERecodeConstants.f"
<BR>
<B>default value:</B> kMacOSCharset ('mac)
<BR>


Defines which characters set is used for the file and the file name.
<BR>
This information is used to convert the file.
<BR><BR>




<B>* command</B>

<BR>

<B>type:</B> string or nil
<BR>
<B>default value:</B> nil
<BR>


If this option is set to a string, the instruction will send this string
and execute it on the remote computer.
<BR>
<I>The syntax of the command depends of the remote computer.
<BR>
This option is mostly used when the remote computer is a Unix system.
<BR>
Example of Unix command: "!ls".
<BR>
This option should not be set if either "batch" or "ioBoxItem" is not nil.</I>

<BR>
<BR>


<B>* encodeControlChars</B>

<BR>

<B>type:</B> boolean
<BR>
<B>default value:</B> nil
<BR>


Encode control characters used by the ZModem protocol to allow operation
with some packet switched networks.


<BR><BR>


<B>* enableFullStreamingWithSamplingSend</B>


<BR>
<B>type:</B> boolean
<BR>
<B>default value:</B> true

<BR>



If this option is set to true, the Newton won't wait for an acknowledge
after each block.
<BR><BR>
<I>If you clear this option the file transfer is slower. So, you should clear
it only when the connection is established without flow control and the
remote computer is very slow.</I>

<BR><BR>



<B>* fileConversion</B>

<BR>

<B>type:</B> integer
<BR>
<B>possible values:</B> defined in the file "EETransferConstants.f"
<BR>
<B>default value:</B> kFileConversion_ZCRESUM (3)
<BR><BR>


<B>kFileConversion_NONE</B> (0)
<BR>
No file conversion.
<BR><BR>


<B>kFileConversion_ZCBIN</B> (1)
<BR>
	"Binary" transfer - inhibit conversion unconditionally.

<BR><BR>

<B>kFileConversion_ZCNL</B> (2)
<BR>
	Convert received end of line to local end of line convention. The
supported end of line conventions are CR/LF (most ASCII based operating
systems except Unix and Macintosh), and NL (Unix). Either of these two end
of line conventions meet the permissible ASCII definitions for Carriage
Return and Line Feed/New Line. Neither the ASCII code nor ZMODEM ZCNL
encompass lines separated only by carriage returns. Other processing
appropriate to ASCII text files and the local operating system may also be
applied by the receiver (Filtering RUBOUT, NULL, Ctrl-Z, etc).

<BR><BR>

<B>kFileConversion_ZCRECOV or kFileConversion_ZCRESUM</B> (3)
<BR>
	Recover/Resume interrupted file transfer. ZCREVOV is also useful
for updating a remote copy of a file that grows without resending of old
data. If the destination file exists and is no longer than the source,
append to the destination file and start transfer at the offset
corresponding to the receiver's end of file. This option does not apply if
the source file is shorter. Files that have been converted (e.g., ZCNL) or
subject to a single ended Transport Option cannot have their transfers
recovered.
<BR><BR>




<B>* fileManagement</B>

<BR>

<B>type:</B> integer
<BR>
<B>possible values:</B> defined in the file "EETransferConstants.f"
<BR>
<B>default value:</B> kFileManagement_NONE (0)
<BR><BR>


<B>kFileManagement_NONE</B> (0)
<BR>
	No file management.
<BR><BR>


<B>kFileManagement_ZMSKNOLOC</B> (0x80);
<BR>
	Instructs the receiver to bypass the current file if the receiver
does not have a file with the same name. NB: this option can be ored with
any of the following constants.
<BR><BR>


<B>kFileManagement_ZMNEWL</B> (1)
<BR>
	Transfer file if destination file absent. Otherwise, transfer file
overwriting destination if the source file is newer or longer.

<BR><BR>

<B>kFileManagement_ZMCRC</B> (2)
<BR>
	Compare the source and destination files. Transfer if file lengths
or file polynomials differ.

<BR><BR>

<B>kFileManagement_ZMAPND</B> (3)
<BR>
	Append source file contents to the end of the existing destination
file (if any).
<BR><BR>


<B>kFileManagement_ZMCLOB</B> (4)
<BR>
	Replace existing destination file (if any).

<BR><BR>

<B>kFileManagement_ZMNEW </B>(5)
<BR>
	Transfer file if destination file absent. Otherwise, transfer file
overwriting destination if the source file is newer.


<BR><BR>
<B>kFileManagement_ZMDIFF</B> (6)
<BR>
	Transfer file if destination file absent. Otherwise, transfer file
overwriting destination if files have different lengths or dates.

<BR><BR>

<B>kFileManagement_ZMPROT</B> (7)
<BR>
	Protect destination file by transferring file only if the
destination file is absent.

<BR><BR>



<B>* hyperTerminalPatch</B>

<BR>

<B>type:</B> boolean
<BR>
<B>default value:</B> true

<BR>

<B>HyperTerminal</B>, a Windows 95 program, has a bug which prevents it to
automatically close its reception window when the file transfer has ended.
<BR>
When this option is set to true, the Newton uses a workaround to
circumvent this bug.
<BR>
This patch adds an overhead of only 1 second, so it is set by default.
<BR><BR>




<B>* ioBoxItem</B>

<BR>

<B>type:</B> ioBox item or nil
<BR>
<B>default value:</B> nil

<BR>

OutBox item to send.
<BR>
<I>This option should not be set if either "batch" or "command" is not nil.</I>

<BR><BR>



<B>* rzString</B>

<BR>

<B>type:</B> string or nil
<BR>
<B>default value:</B> "rz\n"

<BR>

Use this option if you want to send a command to the sender before
starting to send.
<BR>
<I>This option is useful if the Newton is connected to a Unix or DOS server
or a BBS.</I>


<BR><BR>


<B>* transport</B>

<BR>

<B>type:</B> frame

<B>default value:</B> nil

<BR><BR>

<I>The transport must always be EETransfer.</I>
<BR><BR>
<B>Note:</B> Before the script executes itself, the global variable "<B>transport</B>"
is automatically set to EETransfer. So if you don't use a slot
"<B>globalSymbols</B>" you don't have to (and you should not) provide a slot
"<B>transport</B>". Otherwise, the "<B>globalSymbols</B>" slot must contain a slot:
<BR>
<B>transport:</B> 'transport,
		</TD>

		
</TR>

<TR >
		<TD WIDTH=120 >
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  COLSPAN=2>
		<IMG SRC="../pict/bbar.gif" WIDTH=453 HEIGHT=30 BORDER=0>
		</TD>


</TR>


<TR >
		<TD WIDTH=120 >
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>

		<TD WIDTH=453  COLSPAN=2>
		<IMG SRC="../pict/bar.gif" WIDTH=453 HEIGHT=30 BORDER=0>
		</TD>


</TR>

<TR >
		<TD WIDTH=120 >
		&copy;1997 Easter-eggs<BR>
		All trademarks mentioned are the property of their respective owners
		</TD>

		<TD WIDTH=20 >
		</TD>
		
		<TD WIDTH=5>
		</TD>
		
		<TD WIDTH=226  VALIGN="top">
		</TD>


		<TD WIDTH=227 ALIGN="right" VALIGN="top">
		</TD>
		


</TR>


</TABLE>

</BODY>

</HTML>